home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / dta12.zip / DTA.DOC < prev    next >
Text File  |  1988-10-16  |  8KB  |  181 lines

  1.  
  2.                                    DTA.DOC
  3.                                    -------
  4.                            Instructions for DTA.COM
  5.                              Version 1.2 (10/88)
  6.  
  7.                                (c)1988 E. Meyer
  8.  
  9.  
  10.      DTA.COM is a super directory utility that will run on any PC/MSDOS system 
  11. (version 2 or higher).  "DTA" stands for Directory-Tree-Attributes; it is a 
  12. replacement for the DOS DIR, ATTRIB, and TREE commands.  DTA is written 
  13. entirely in 8086 assembler, and has many advantages including:
  14.  
  15.     *  alphabetized directory with file sizes and free space
  16.     *  default compact display; optionally include attributes and time/date
  17.     *  select items by file attributes or today's time stamp
  18.     *  change any file attributes
  19.     *  treat directories separately or together with files
  20.     *  alphabetized compact subdirectory tree; optionally include sizes
  21.  
  22.  
  23.                                   USING DTA
  24.                                   ---------
  25.  
  26. SYNTAX:    A>dta {filespec} {/options}           ("{}"=optional)
  27.  
  28.         where  "filespec" may include a drive, path, or wildcards;
  29.                "/" is the delimiter for option letters.
  30.  
  31.      If the drive or path is omitted, the defaults are the active ones.  If 
  32. the filespec is omitted it defaults to "*.*".  If it is a directory name, the 
  33. contents of the directory are displayed.  If it is an unambiguous filename (no 
  34. wildcards), and no option was specified, /F mode is automatically invoked.
  35.      Options are discussed in detail below.  If none are specified, you will 
  36. get a compact, informative directory display.
  37.  
  38.      You can pause or abort during operation of DTA by typing ^S or ^C.  
  39. Output can be directed to a file or other device in the standard fashion:
  40.                 A>DTA FILESPEC /OPTIONS >DEVICE.
  41.  
  42.  
  43.                                  DTA OPTIONS
  44.                                  -----------
  45.  
  46.      By default, DTA will display a list of all files specified, along with 
  47. their sizes, and some disk space information.  You can modify this consid- 
  48. erably with a variety of options.  One "/" must precede any options; further 
  49. slashes may be used or not as desired.
  50.  
  51.      /? = help.  Gives a brief summary of DTA usage and options.
  52.  
  53. There is an option to show part of a tree, instead of displaying files:
  54.      /T = subdirectory tree, starting at specified or current directory.
  55.  
  56. Then there are several options affecting the appearance of the display:
  57.      /F = full: for files, show attributes and time stamps.
  58.                 for directory tree, show total size of contents.
  59.      /V = version: include the DTA version message.
  60.      /W = wide: just like DIR /W, five columns with no file sizes.
  61.      /N = narrow: use only half the usual number of columns.
  62.      /P = paginate: pause every 24 lines for a keystroke.
  63.  
  64. Then there are options to select what items are chosen for display:
  65.      /D = directories: look at directories instead of files.
  66.      /U = universal: look at both directories and files.
  67.      /M = modified: select only items created or modified today.
  68.      /A,H,R,S = select only items with the specified attributes:
  69.                   Archive; Hidden; Read/only; System.
  70.      /a,h,r,s = select only items WITHOUT these attributes.
  71.  
  72. Finally, you can specify:
  73.      /C = change items to have the following specified attributes.
  74.  
  75.      Note that the attributes are case sensitive.  Those listed alone, or 
  76. before the "C" option, are used for selection; those after it, represent 
  77. changes to be made.  The /C option with NO following attributes will still 
  78. cause attributes to display instead of file sizes, though no attributes will 
  79. be changed.
  80.  
  81.      The best way to make DTA usage clear will be by a series of examples.
  82.  
  83.  
  84.                        EXAMPLES: FILES and DIRECTORIES
  85. C>dta a:\*.sys
  86.   Show all files *.SYS in the root directory on A:.  (System, etc included.)
  87. C>dta a:\*.sys /f
  88.   Same thing, but with "full" display including attributes and timestamps.
  89. C>dta \work /m
  90.   Show only those files in directory C:\WORK created or modified today.
  91. C>dta /d
  92.   Show all subdirectories in the current directory.
  93. C>dta \work /u
  94.   Show all files AND subdirectories in C:\WORK.
  95.  
  96.                              EXAMPLES: ATTRIBUTES
  97. C>dta /c
  98.   Show all files in current directory with their attributes.
  99. C>dta /A
  100.   Show all files in current directory marked with the Archive attribute.
  101. C>dta a: /SH
  102.   Show all files in current directory on A: which are System and Hidden.
  103. C>dta a:*.sys /Hca
  104.   Select all Hidden files *.SYS on A: and clear their Archive attribute.
  105.  
  106.                                 EXAMPLE: TREES
  107. C>dta \ /t
  108.   Show the entire directory tree, from the root, on drive C:.
  109.  
  110.                                      QUIZ
  111.  
  112.      All right: can you decide what the following commands would accomplish:
  113.               A>dta /vfn >prn           B>dta a: /u /c /p
  114.               A>dta *.syz /smAca        C\SUE\TEMP>dta \ /f/d/H
  115.               C\SUE\TEMP>dta .. /tf
  116. (Sorry if this seems cryptic at first; you'll catch on.  Nobody will force you 
  117. to use all these fool options; many exist only to allow you to get hard copy 
  118. exactly the way you want it.  Again, you can always type "DTA /?" for help.)
  119.  
  120.  
  121.                            INTERPRETING THE DISPLAY
  122.                            ------------------------
  123.  
  124.      File SIZES are displayed to the nearest kilobyte (or "k"; 1k is 1024 
  125. bytes).  The "used/free" space shown by DTA is for the entire drive.  The 
  126. "item total" is only for the files listed; it does not include any other files 
  127. in the directory.  Because allocation clusters on a disk can vary from 128 
  128. bytes (on a RAMdisk) to 4k or more (on a hard disk), the space actually "used" 
  129. can be several K more or a fraction of a K less than a file's reported size.
  130.  
  131.      File ATTRIBUTES, when displayed, show as a letter ("A,H,R,S") if set, or 
  132. as "." if clear.  The Archive attribute indicates to a backup utility that a 
  133. file has been changed recently, and needs to be backed up; the bit is cleared 
  134. by the utility when it does so.  (Simple backup utilities that work well with 
  135. DA include the DOS XCOPY command, and my own ARCOPY.COM.)
  136.      The Read/only attribute prevents a file from being changed or deleted, 
  137. though it can be read and copied.  The Hidden and System attributes both 
  138. exclude a file from normal searches: such files cannot be accessed at all by 
  139. ordinary MSDOS file commands.  Ordinarily only the DOS boot files MSDOS.SYS 
  140. and IO.SYS have these attributes.  (If you do NOT want to see hidden or system 
  141. files, use "/sh".)
  142.  
  143.      DTA can display up to 1000 files, 64 MB total size.  If any file exceeds 
  144. 999k, its size won't display properly, but other statistics will be correct.
  145.  
  146.  
  147.                                 ERROR MESSAGES
  148.  
  149.      "0 item(s)" - No such file (or directory) was found.  (If you expected 
  150. there to be some, check your arguments again...)
  151.  
  152.      "<invalid argument>" - You guessed it.  Invalid option, bad path, illegal 
  153. character in filename, that sort of thing.  Think and try again.  (Note some 
  154. arguments conflict: you can't specify /ud, or /Aa.)
  155.  
  156.      "<out of memory>" - Very unlikely.  Either you're almost out of memory, 
  157. or there were a ridiculous number of items to be displayed.
  158.  
  159.  
  160.                                    HISTORY
  161.  
  162.      DA version 1.0 (9/87) was loosely based on my earlier program DA.COM for 
  163. CP/M systems.  Everybody has their own taste in a DIR utility... I use the 
  164. Archive and Read/only attributes frequently, and find a directory utility that 
  165. can also display and change them useful.
  166.      DA 1.1 (7/88) - better argument parsing; attributes can now be both 
  167. selected on and changed, eg: "/Aca"; several new options.
  168.      DTA 1.2 (10/88) - added "/T" option: a TREE that fits on the screen!
  169.  
  170.  
  171.      DTA and its documentation are (c)1988 E.Meyer, all rights reserved.  They 
  172. may be freely distributed, but not modified or sold for profit without my 
  173. written consent.  The user takes full responsibility for any damages resulting 
  174. from the use (o